<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      xfsprogs-5.5.0
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;5.&nbsp;File Systems and Disk Management
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="sshfs.html" title="sshfs-3.7.0">Prev</a>
          <p>
            sshfs-3.7.0
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="editors.html" title="Editors">Next</a>
          <p>
            Editors
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="filesystems.html" title=
          "Chapter&nbsp;5.&nbsp;File Systems and Disk Management">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="xfsprogs" name="xfsprogs"></a>xfsprogs-5.5.0
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to xfsprogs
        </h2>
        <p>
          The <span class="application">xfsprogs</span> package contains
          administration and debugging tools for the XFS file system.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://www.kernel.org/pub/linux/utils/fs/xfs/xfsprogs/xfsprogs-5.5.0.tar.xz">
                https://www.kernel.org/pub/linux/utils/fs/xfs/xfsprogs/xfsprogs-5.5.0.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: a3c284f21658796ca60e94d6594b09d4
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 1.2 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 63 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.3 SBU (Using parallelism=4)
              </p>
            </li>
          </ul>
        </div>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/xfs">http://wiki.linuxfromscratch.org/blfs/wiki/xfs</a>
        </p>
      </div>
      <div class="kernel" lang="en" xml:lang="en">
        <h2 class="sect2">
          <a id="xfsprogs-kernel" name="xfsprogs-kernel"></a>Kernel
          Configuration
        </h2>
        <p>
          Enable the following options in the kernel configuration and
          recompile the kernel:
        </p>
        <pre class="screen">
<code class="literal">File systems ---&gt;
  &lt;*/M&gt; XFS filesystem support [CONFIG_XFS_FS]</code>
</pre>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of xfsprogs
        </h2>
        <p>
          Install <span class="application">xfsprogs</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">make DEBUG=-DNDEBUG     \
     INSTALL_USER=root  \
     INSTALL_GROUP=root \
     LOCAL_CONFIGURE_OPTIONS="--enable-readline"</kbd>
</pre>
        <p>
          This package does not come with a test suite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class=
"command">make PKG_DOC_DIR=/usr/share/doc/xfsprogs-5.5.0 install     &amp;&amp;
make PKG_DOC_DIR=/usr/share/doc/xfsprogs-5.5.0 install-dev &amp;&amp;

rm -rfv /usr/lib/libhandle.a                                &amp;&amp;
rm -rfv /lib/libhandle.{a,la,so}                            &amp;&amp;
ln -sfv ../../lib/libhandle.so.1 /usr/lib/libhandle.so      &amp;&amp;
sed -i "s@libdir='/lib@libdir='/usr/lib@" /usr/lib/libhandle.la</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class="command"><strong>make DEBUG=-DNDEBUG</strong></span>:
          Turns off debugging symbols.
        </p>
        <p>
          <em class="parameter"><code>INSTALL_USER=root
          INSTALL_GROUP=root</code></em>: This sets the owner and group of
          the installed files.
        </p>
        <p>
          <em class=
          "parameter"><code>LOCAL_CONFIGURE_OPTIONS="..."</code></em>: This
          passes extra configuration options to the <code class=
          "filename">configure</code> script. The example <em class=
          "parameter"><code>--enable-readline</code></em> parameter enables
          linking the XFS programs with the <code class=
          "filename">libreadline.so</code> library, in order to allow editing
          interactive commands.
        </p>
        <p>
          <code class="option">OPTIMIZER="..."</code>: Adding this parameter
          to the end of the <span class=
          "command"><strong>make</strong></span> command overrides the
          default optimization settings.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">fsck.xfs, mkfs.xfs, xfs_admin, xfs_bmap,
              xfs_copy, xfs_db, xfs_estimate, xfs_freeze, xfs_fsr,
              xfs_growfs, xfs_info, xfs_io, xfs_logprint, xfs_mdrestore,
              xfs_metadump, xfs_mkfile, xfs_ncheck, xfs_quota, xfs_repair,
              xfs_rtcp, and xfs_spaceman</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">libhandle.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/include/xfs and
              /usr/share/doc/xfsprogs-5.5.0</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="fsck.xfs" name="fsck.xfs"></a><span class=
                    "term"><span class=
                    "command"><strong>fsck.xfs</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    simply exits with a zero status, since XFS partitions are
                    checked at mount time.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="mkfs.xfs" name="mkfs.xfs"></a><span class=
                    "term"><span class=
                    "command"><strong>mkfs.xfs</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    constructs an XFS file system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_admin" name="xfs_admin"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_admin</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    changes the parameters of an XFS file system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_bmap" name="xfs_bmap"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_bmap</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prints block mapping for an XFS file.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_copy" name="xfs_copy"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_copy</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    copies the contents of an XFS file system to one or more
                    targets in parallel.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_estimate" name="xfs_estimate"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_estimate</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    for each directory argument, estimates the space that
                    directory would take if it were copied to an XFS
                    filesystem (does not cross mount points).
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_db" name="xfs_db"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_db</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to debug an XFS file system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_freeze" name="xfs_freeze"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_freeze</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    suspends access to an XFS file system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_fsr" name="xfs_fsr"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_fsr</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    applicable only to XFS filesystems, improves the
                    organization of mounted filesystems, the reorganization
                    algorithm operates on one file at a time, compacting or
                    othewise improving the layout of the file extents
                    (contiguous blocks of file data).
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_growfs" name="xfs_growfs"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_growfs</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    expands an XFS file system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_info" name="xfs_info"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_info</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is equivalent to invoking <span class=
                    "command"><strong>xfs_growfs</strong></span>, but
                    specifying that no change to the file system is to be
                    made.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_io" name="xfs_io"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_io</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a debugging tool like <span class=
                    "command"><strong>xfs_db</strong></span>, but is aimed at
                    examining the regular file I/O path rather than the raw
                    XFS volume itself.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_logprint" name="xfs_logprint"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_logprint</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prints the log of an XFS file system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_mdrestore" name=
                    "xfs_mdrestore"></a><span class="term"><span class=
                    "command"><strong>xfs_mdrestore</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    restores an XFS metadump image to a filesystem image.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_metadump" name="xfs_metadump"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_metadump</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    copies XFS filesystem metadata to a file.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_mkfile" name="xfs_mkfile"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_mkfile</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    creates an XFS file, padded with zeroes by default.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_ncheck" name="xfs_ncheck"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_ncheck</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    generates pathnames from inode numbers for an XFS file
                    system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_quota" name="xfs_quota"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_quota</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a utility for reporting and editing various aspects of
                    filesystem quota.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_repair" name="xfs_repair"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_repair</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    repairs corrupt or damaged XFS file systems.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_rtcp" name="xfs_rtcp"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_rtcp</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    copies a file to the real-time partition on an XFS file
                    system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xfs_spaceman" name="xfs_spaceman"></a><span class=
                    "term"><span class=
                    "command"><strong>xfs_spaceman</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    reports and controls free space usage in an XFS file
                    system.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libhandle" name="libhandle"></a><span class=
                    "term"><code class="filename">libhandle.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains XFS-specific functions that provide a way to
                    perform certain filesystem operations without using a
                    file descriptor to access filesystem objects.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-25 16:46:27 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="sshfs.html" title="sshfs-3.7.0">Prev</a>
          <p>
            sshfs-3.7.0
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="editors.html" title="Editors">Next</a>
          <p>
            Editors
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="filesystems.html" title=
          "Chapter&nbsp;5.&nbsp;File Systems and Disk Management">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
